Manipular los objetos 4D Chart

Un documento 4D Chart se compone de diferentes objetos como gráficos, etiquetas de los ejes, texto escrito, imágenes, etc.  4D Chart le permite manejar estos objetos por programación.

Esta sección se describe cómo por programación:

• Hacer referencia a objetos,
• Especificar las coordenadas de un objeto,
• Especificar el alcance de un comando.

Cada objeto en un documento 4D Chart recibe un número único de identificación. Este número se conoce como ID del objeto y se asigna cuando se crea el objeto.

Esto significa que cada vez que el usuario crea un gráfico, dibuja un objeto con la paleta de herramientas, pega un objeto del Portapapeles, agrupa varios objetos, duplica un objeto existente, o pega una referencia de campo, se asigna una nueva identificación. Como el ID de objeto es único, los identificadores son una manera conveniente para referirse a objetos. Los identificadores de objetos no se vuelven a utilizar dentro de un documento. Incluso si se elimina un objeto, su número es "retirado" de por vida del documento.

Los identificadores de objetos no son transferibles. Un objeto cuyo ID es igual a 5 en un documento 4D Chart no necesariamente tendrá la misma identificación si se pega en otro documento.

Todos los comandos de creación de objetos estándar son funciones y devuelven el ID del objeto resultante. A diferencia de los objetos creados por el usuario a través de la paleta, los objetos creados a través de los comandos no se seleccionan automáticamente.

Puede obtener el ID de un objeto utilizando la función CT Get ID.

La posición y el tamaño de un objeto consituyen sus coordenadas. Todos los comandos que describen o especifican las coordenadas lo hacen en puntos.

Los comandos que describen o especifican una posición lo hacen con respecto al origen. El origen es la intersección de los puntos cero en las reglas horizontal y vertical. El siguiente diagrama ilustra el sistema de coordenadas.

Muchos comandos 4D Chart tienen un parámetro llamado alcance, que especifica cuales objetos o caracteres de texto en un documento 4D Chart se ven afectados por el comando.

En la siguiente tabla se describen las reglas generales de alcance. Para saber como alcance afecta a un determinado comando, consulte la descripción de dicho comando.